home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1996 April / Macworld (1996-04).dmg / Shareware World / Entertainment / Card Games / 500Cards Folder / Read Me! < prev   
Text File  |  1994-05-15  |  8KB  |  86 lines

  1. 500 Cards (v0.9.3) by Denis A. Birnie.
  2. ==============================
  3.  
  4. Release Notes:
  5. • I've used SimpleText as the editor for this ReadMe!  If you don't have SimpleText (ie. the title isn't in bold 18pt Times) you should install the Hardware System Update version 3 which has just been released!!!
  6. • I've fiddled with the bidding code to (re)balance it: the computer players more frequently bid suits other than NoTrumps. I've also added a "Level" menu to the game which allows you to select how 'brave'/'rash' the computer players are with their bidding (it doesn't affect how they play).  To change the level you must close the game window.
  7. • The deepest offworld the game will open is now 8 bits deep - I suspect that this was the cause of the PowerMac problems - a 16 bit+ offworld is BIG!
  8.  
  9. Game Instructions:
  10. I started writing 500 Cards as a programming exercise during one of the holidays I summered over at the University of Otago.  Having now left Dunedin I've "completed" it as a way of replacing my (psuedo)flatmates - who could never be relied on to finish a game of 500(or look at beta software it seems;-).  It's a fairly standard implementation of four handed Five Hundred; you and a computer partner versus an all computer partnership - the first side to score 500 wins (or -500 looses).
  11.  
  12. Getting Started.
  13. Double click on the App and a new game will start automagically; volia - there's your card table, your hand (the row of ten cards displayed at the bottom of the window) and three other players! (your partner has the top card position).
  14. At this point you might want to change the game level from the default 'Safe' to one of the other three options.  To do this close the game window and select a level from the Level menu.  Then start a new game.
  15.  
  16. Bidding.
  17. It's really simple - just click on any card of the suit you'd like to bid, the computer will ensure you bid the minimum legal number of tricks.  If you want to bid higher just click on the same (or any other) suit.  Clicking on the Joker is just like clicking on the "No Trumps" button.  When you're happy with your bid click on the "Bid" button.
  18. Note that if you have no picture cards there is a redeal button instead of the grayed-out bid button - picking a suit will cause the bid button to appear.  (The computer players can also opted for redeals, but you probably won't notice them doing it).
  19.  
  20. Discarding.
  21. So you've won the bidding - now you get to see the kitty and swap about cards to your hearts content.  How? Simple, just click on a card in your hand that you want to discard and then click on a card in the kitty that you'd like in your hand.  Or you could do it the other way around!  The button which finishes discarding should be obvious.
  22.  
  23. Playing.
  24. Just as per standard 500!  Whose standard? My not too specific standard!  The only real hard and fast rule is that if possible all players must follow suit (in No Trumps the Joker is of no particular suit - hence you could end up being forced to play it last!).  Tabled cards can't be taken back.
  25. After each trick there is a slight pause so that you can see what every one else has played - if the pause is too long just click!
  26.  
  27. You can start a new game at any time, though a warning dialog will appear if a game is in progress.  A similar warning appears when you quit or close the game window.
  28.  
  29.  
  30. And that's it!!!!!!
  31.  
  32.  
  33. So just who am I playing?
  34. Well, the "algorithm" the computer players use is a long and confused set of empirical rules I've developed by reflecting on how I play 500 - hopefully I have covered all the obvious things!  All three computer players use exactly the same routines and (excluding bugs) they don't cheat (needless to say - they don't play brilliantly at the moment either! ;-).  And yes, I count looking at the kitty as cheating.
  35.  
  36. But, where do the computer player names come from?
  37. OK, The built in names are: my beta testers (Deborah(workmate) & Lincoln(my brother)), my wife Lynne (who has let me spend so much time on this that I actually finished!), my parents (Jennifer & Allan), my very old cardbuddies from senior highschool (Craig & Chris - eventually no-one would play against our parterships), my sister (Fiona), our family cat (Scooby) and myself; Denis.
  38.  
  39.  
  40.  
  41. Latest Features (newest -> oldest):
  42. • Used SimpleText as the editor for this ReadMe!
  43. • Added a "Level" menu to the game - this allows you to select how 'brave'/'rash' the computer players are with their bidding - it doesn't affect how they play.
  44. • Fixed graphics and GUI consistency problems.  Also reworked the main event loop to be not such a good co-operative multitasking one - though the computer players 'function' quicker as a result.
  45. • The deepest offworld the game will open is now 8 bits deep - I suspect that this was the cause of the PowerMac problems - a 16 bit+ offworld is BIG!
  46. • Fiddled with the bidding balance (again) - now doesn't have quite the tendency to bid NoTrumps.
  47. • Added a "Redeal" button to the bidding section - it only appears if you have no picture cards and haven't bid!
  48. • Revamped computer bidding - two different averaged criteria have to be passed before the computer will bid (can still be a bit changeable and just plain stupid).
  49. • Can now start a new game (automatically aborting the old!)
  50. • FIXED Obscure "4 of No Trumps" bug - beeping during a Computer Player picking their card indicates my last defence code is trying to stop this bug (Doh!).
  51. • Program now automatically senses the number of player names available (must be at least four (or it beeps)). DON'T HAVE LESS THAN FOUR - CAN YOU SAY "ENDLESS LOOP"?
  52. • Colour!!! This turned out to be easier than I thought - it's pretty simple stuff; just Black, White, Red, Green and a little bit of Blue.  The best colour modes are 4bit and up - gray scale and 2bit colour don't do much for me!  B/W works well and is the quickest.  
  53.  
  54.  
  55. Things to be done soon :
  56. •Add a dialog to get the (Human) Player's name.
  57.   (Currently its either "You" or the first word of the Mac's Owner
  58.     Name (which is set via the Sharing Setup control panel))
  59. •Probably add a preference file (to store the player name).
  60. •Smarten up the computer players.
  61.   – As a co-worker has pointed out the computer players tend to
  62.      over bid at the end game.
  63. •Any (good) ideas suggested.
  64.  
  65. Things to be done later:
  66. •Some sort of HighScore table.
  67.   (maybe two tables:- "Best Winners" and "Worst Losers"?). Ideas?
  68.   (the fewer hands played and the more points won the better?)
  69. •Smarten up the computer players (again).
  70. •Any (interesting) ideas suggested.
  71.  
  72.  
  73. STILL Reading?
  74.  
  75. This program was originally written in MacPascal on a Mac Plus.  The modern version was written on a Classic and then a Colour Classic using ThinkC 5.0.4 (after converting the Pascal using CTools).  The move to a real, event-driven Application was made possible by the purchase of that most excellent Mac D-I-Y programming book :- Macintosh_Programming_Secrets (2nd Ed), written by Scott Knaster and Keith Rollin (who's been really helpful over the Net whenever I've contacted(pestered) him(Thanks)).  Also of assistance were; NIM:OV, NIM:MTE, lurking on COMP.SYS.MAC.PROGRAMMING and the Inside_Mac da.
  76.  
  77.  
  78. Until the end of 1995 (at least) I should be reachable on the InterNet via the address "D.Birnie@Regy.Canterbury.ac.NZ"
  79.  
  80. Denis, 15/5/94
  81.  
  82. PS - If you don't happen to have a very scenic hometown then consider this software to be Some- Place- I've- Lived- Thats- Nicer- Than- The- Hole- I- Was- Born- In- PostCard- Ware!!!
  83.  
  84. What Next?
  85. Well, I've got a little Railway Simulation that will probably go nowhere.  At the moment I'm toying with redoing a I wrote many years ago on my C-64; a maze'n'monsters thing in 6502…